Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 4 - Dialog Manager Reference / Dialog Manager Functions

Handling Text in Alert and Dialog Boxes /

SetDialogItemText

CHANGED WITH THE APPEARANCE MANAGER

Sets the text string for static text and editable text fields.

pascal void SetDialogItemText (
                     Handle item,
                     ConstStr255Param text);

item

A handle to an editable text or static text field. When embedding is on, you should pass in the control handle produced by a call to the function GetDialogItemAsControl. If embedding is not on, pass in the handle produced by the GetDialogItem function.

text

A pointer to a string containing the text to display in the field.

DISCUSSION

The SetDialogItemText function sets and redraws text strings for static text and editable text fields. SetDialogItemText is useful for supplying a default text string--such as a document name--for an editable text field while your application is running.

WHEN THE APPEARANCE MANAGER IS NOT AVAILABLE

An embedding hierarchy cannot be established in a dialog box.